home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / oldwish / RCS / wish.man,v < prev    next >
Encoding:
Text File  |  1989-01-20  |  10.2 KB  |  269 lines
  1. head     1.2;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.2
  10. date     89.01.19.16.44.25;  author mgbaker;  state Exp;
  11. branches ;
  12. next     1.1;
  13.  
  14. 1.1
  15. date     89.01.17.23.44.26;  author mgbaker;  state Exp;
  16. branches ;
  17. next     ;
  18.  
  19.  
  20. desc
  21. @Initial manual page for wish.
  22. @
  23.  
  24.  
  25. 1.2
  26. log
  27. @Added warnings about broken options.
  28. @
  29. text
  30. @' Copyright 1989 Regents of the University of California
  31. ' Permission to use, copy, modify, and distribute this
  32. ' documentation for any purpose and without fee is hereby
  33. ' granted, provided that this notice appears in all copies.
  34. ' The University of California makes no representations about
  35. ' the suitability of this material for any purpose.  It is
  36. ' provided "as is" without express or implied warranty.
  37. ' 
  38. ' $Header: /a/newcmds/wish/RCS/wish.man,v 1.1 89/01/17 23:44:26 mgbaker Exp Locker: mgbaker $ SPRITE (Berkeley)
  39. ' 
  40. .so \*(]ltmac.sprite
  41. .HS WISH cmds
  42. .BS
  43. .SH NAME
  44. wish \- Window shell and directory browser for X windows
  45. .SH SYNOPSIS
  46. .nf
  47. \fBwish\fR [\fIoptions\fR] [\fIdirectory\fR]
  48. .SH OPTIONS
  49. .IP "\fB\-nopick\fR" 14
  50. Configure \fBwish\fR so that it will not automatically pick an initial window
  51. size.  Due to X11 changes, this option is temporarily misbehaving.
  52. .IP "\fB\-resize\fR" 14
  53. Configure \fBwish\fR so that it will automatically resize a window whenever it
  54. thinks the window's contents have changed in such a way that another
  55. size would be better.  Due to X11 changes, this option is temporarily
  56. misbehaving.
  57. .IP "\fB\-empty\fR" 14
  58. Display headers for file groups that don't match any files.  The default
  59. is to display headers for file groups that contain files.
  60. .IP "\fB\-debug\fR" 14
  61. Print debug messages and do not fork into the background.  This option is
  62. primarily useful for debugging \fBwish\fR.
  63. .BE
  64. .SH DESCRIPTION
  65. .PP
  66. \fBWish\fR is a command shell and directory browser that uses the facilities
  67. of the X window system, the Sx supplementary library, and the Tcl command
  68. interpreter.  It displays a window containing a configurable list of files
  69. in the directory
  70. specified on the command line, or the directory in which it is started,
  71. if the user does not specify a command-line directory.  Because \fBwish\fR uses
  72. the Sx and Tcl facilities, its selection and other capabilities are
  73. compatible with the \fBmx\fR editor and the \fBtx\fR terminal emulator.
  74. .LP
  75. Commands are invoked through menus and key and mouse button bindings.  All
  76. three of these methods are configurable by the user, because all three of
  77. these methods actually invoke the commands through the Tcl command interpreter.
  78. .LP
  79. \fBWish\fR groups files on its display according to rules provided by the
  80. user.  These rules can include pattern-matching on the file names and various
  81. other properties, including arbitrary rules that the user can specify through
  82. Tcl procedures.  The default list of files contains all the files in the
  83. directory. (Another way of saying this is that the default matching rule
  84. is the pattern \fB*\fR.)  The user can choose attributes he wants displayed
  85. for the files, such as access times and sizes, and he can sort the files
  86. according to different attributes as well.
  87. .LP
  88. \fBWish\fR also provides user-configurable command binding that includes
  89. keyboard bindings, mouse-button bindings and also per-file-group bindings.  The
  90. latter makes it possible, for instance, to use the left mouse button to invoke
  91. a compiler by clicking on \fB*.c\fR files, but a text formatter when clicking
  92. on \fB*.tex\fR files.
  93. .LP
  94. The following sections of this manual page describe the configuration, options,
  95. and possible commands for \fBwish\fR.
  96. .LP
  97.  
  98. .SH  CONFIGURATION OPTIONS AND STARTUP COMMANDS
  99. .PP
  100. Currently most options are specified via a \fB.Xdefaults\fR file and
  101. a \fB.wish\fR file.  More command-line support will be added eventually.
  102. The following list gives the options that can be set in a
  103. user's \fB.Xdefaults\fR file, which is the general X-application startup
  104. file.  The
  105. second section describes options configurable from a wish-specific startup
  106. file, \fB.wish\fR.  \fBWish\fR will startup pleasantly even if one or both
  107. of these files are missing, but it will choose its own default configuration
  108. in this case.
  109. .SH 2 X DEFAULT OPTIONS
  110. .IP "\fBBackground\fR" 16
  111. General background color for \fBwish\fR window.
  112. .IP "\fBForeground\fR" 16
  113. General foreground color for \fBwish\fR window.
  114. .IP "\fBBorder\fR" 16
  115. Color for border of \fBwish\fR window.
  116. .IP "\fBBorderWidth\fR" 16
  117. Width of border around \fBwish\fR window.
  118. .IP "\fBSelection\fR" 16
  119. Color of selection highlighting.
  120. .IP "\fBTitleBackground\fR" 16
  121. Background color of title bar.
  122. .IP "\fBTitleForeground\fR" 16
  123. Foreground color of title bar.
  124. .IP "\fBTitleBorder\fR" 16
  125. Color of border around title bar.
  126. .IP "\fBTxBackground\fR" 16
  127. Background color of attached tx window.
  128. .IP "\fBTxForeground\fR" 16
  129. Foreground color of attached tx window.
  130. .IP "\fBTxBorder\fR" 16
  131. Border color for attached tx window.
  132. .IP "\fBMenuBackground\fR" 16
  133. Background color for menu bar.
  134. .IP "\fBMenuForeground\fR" 16
  135. Foreground color for menu bar.
  136. .IP "\fBSortBackground\fR" 16
  137. Background color for bar specifying current file-sorting method.
  138. .IP "\fBSortForeground\fR" 16
  139. Foreground color for bar specifying current file-sorting method.
  140. .IP "\fBFieldsBackground\fR" 16
  141. Background color for bar specifying displayed file attributes.
  142. .IP "\fBFieldsForeground\fR" 16
  143. Foreground color for bar specifying displayed file attributes.
  144. .IP "\fBEntryBackground\fR" 16
  145. Background color for bar allowing command entry.
  146. .IP "\fBEntryForeground\fR" 16
  147. Foreground color for bar allowing command entry.
  148. .IP "\fBScrollBackground\fR" 16
  149. Background color for scroll bar.
  150. .IP "\fBScrollForeground\fR" 16
  151. Foreground color for scroll bar.
  152. .IP "\fBScrollElevator\fR" 16
  153. Color for elevator in scroll bar.
  154. .IP "\fBGeometry\fR" 16
  155. Window geometry.
  156. .IP "\fBFont\fR" 16
  157. Font to use in \fBwish\fR window.
  158. .IP "\fBTitleFont\fR" 16
  159. Font to use in title bar.
  160. .SH 2 WISH STARTUP OPTIONS
  161. .PP
  162. The \fBwish\fR startup file, \fB.wish\fR, is used for configuring the behavior
  163. of \fBwish\fR initially, and for changing its behavior if the user changes
  164. direcotories.  Thus, each directory may have a different \fB.wish\fR file, if
  165. this is useful.
  166. .IP "\fB selection binding\fR" 20
  167. The Tcl command
  168. .br
  169. \fBvar selectionButton \fIbutton\fR
  170. .br
  171. will set \fIbutton\fR
  172. (left, right, {shift right}, etc) to be the mouse
  173. button used for selecting files and text in a \fBwish\fR window.
  174. .IP "\fBfile sorting\fR" 20
  175. The Tcl command \fBsortFiles \fImethod\fR will configure \fBwish so that
  176. inside a file group, it sorts the files by \fImethod\fR.  The default method
  177. is \fBalpha\fR for alphabetical sorting, but files may also be sorted by
  178. access times, data-modification times, size etc.  They may also be sorted
  179. in reverse order for any method.
  180. .IP "\fBdisplay fields\fR" 20
  181. The Tcl command \fBsetFields \fIfieldname\fR will add the field \fIfieldname\fR
  182. to the file attributes \fBwish\fR is currently displaying.  The default
  183. field is \fBname\fR, but other fields are \fBaccessTime\fR, \fBsize\fR, etc.
  184. \fBWish\fR will try to interpret many types of capitalizations and
  185. abbreviations for each field name.
  186. .IP "\fBdefining groups\fR" 20
  187. The Tcl command \fBdefineGroup\fR is used to define a list of files to
  188. group together on the display.  The command has two options:
  189. \fBdefineGroup comparison \fIpattern\fR create a group that chooses files
  190. using the matching rule \fIpattern\fR on file names.  For example, the command
  191. .sp
  192. \fBdefineGroup comparison B*.ms\fR
  193. .sp
  194. will create a group containing all files starting with the letter `B' and
  195. ending with the suffix `.ms'.  The other option, for arbitrary matching
  196. rules, is
  197. .br
  198. \fBdefineGroup proc \fITcl procedure\fR,
  199. .br
  200. where the given
  201. \fITcl procedure\fR must have a name, which will be the name displayed in the
  202. file group header, and parameter which takes the name of a file to test
  203. against the rule.  The rule is in the Tcl procedure body, and it must
  204. return 1 if the file matches, 0 if not, and a value less than 0 if an error
  205. occurs.  For example, the following defineGroup command will choose all
  206. files beginning with a `.', but excluding the files `.' and `..'.
  207. .sp
  208. \fBdefineGroup proc {proc DotFiles filename {
  209. .br
  210.     return [pattern {!(.) && !(..) && (.*)} $filename]
  211. .br
  212. }}\fR
  213. .sp
  214. The procedure \fBpattern\fR can be called to do arbitrary filename matching.
  215. .IP "\fBper-group command bindings\fR" 14
  216. The command \fBgroupBind \fIgroupName binding command\fR is used to bind
  217. a command, \fIcommand\fR, to a mouse binding, \fIbinding\fR,
  218. for files in a particular group, \fIgroupName\fR.  Following the usual
  219. Tcl syntax, if the command or the binding use more than one word, they
  220. must be enclosed in braces.  For instance, the following will bind the mouse
  221. button \fBshift middle\fR to execute the shell command \fBcc -g -c filename\fR,
  222. on files in the group with suffix `.c'.  The Tcl variable \fB$pointed\fR holds
  223. the name of the file pointed to with the command binding.
  224. .sp
  225. \fBgroupBind *.c {shift middle} {exec cc -g -c $pointed}\fR
  226. .sp
  227. The command \fBexec\fR is used to escape to the user's outside shell (C-shell,
  228. etc), but commands internal to \fBwish\fR can be specified directly.
  229. .IP "\fBkeyboard bindings\fR" 14
  230. Key bindings that aren't specific to particular file groups are specified
  231. with the same mechanism that \fBmx\fR and \fBtx\fR.  See their documentation
  232. for details.
  233. .IP "\fBmenu creation\fR" 14
  234. Menus are created using the same mechanism that \fBmx\fR and \fBtx\fR use.
  235. See their documentation for details.
  236.  
  237. .SH OTHER COMMANDS
  238. .PP
  239. Other commands can be found on the default set of menus.  These include
  240. commands to change directories, open new \fBwish\fR windows in other
  241. directories, etc.
  242. .LP
  243. Some commands can be invoked by using the mouse or by typing in particular
  244. places.  For instance, to change directories, the user need not use the
  245. \fBchangeDirectory\fR command from a menu or from his key bindings.  He can
  246. instead type the new directory name into the title bar that displays the
  247. current directory.  Similarly, typing in the bars that display the
  248. name of a group will change the pattern used for matching files for that group.
  249. .SH KEYWORDS
  250. command shell, X windows, directory browser
  251. @
  252.  
  253.  
  254. 1.1
  255. log
  256. @Initial revision
  257. @
  258. text
  259. @d9 1
  260. a9 1
  261. ' $Header: /sprite/lib/forms/RCS/proto.man,v 1.3 89/01/09 11:43:01 ouster Exp $ SPRITE (Berkeley)
  262. d22 1
  263. a22 1
  264. size.
  265. d26 2
  266. a27 1
  267. size would be better.
  268. @
  269.